home *** CD-ROM | disk | FTP | other *** search
/ Aminet 31 / Aminet 31 (1999)(Schatztruhe)[!][Jun 1999].iso / Aminet / gfx / board / rtgPIP.readme < prev   
Encoding:
Text File  |  1999-05-02  |  4.2 KB  |  123 lines
  1. Short:    Rtgmaster PIP Sublibrary
  2. Author:   MagicSN@Birdland.es.bawue.de
  3. Uploader: MagicSN@Birdland.es.bawue.de
  4. Type:     gfx/board
  5. Required: gfx/board/rtgmaster_user.lha
  6.  
  7. This is a new sublibrary for rtgmaster, which will be included in
  8. future versions of rtgmaster in the main archive.
  9.  
  10. It is a sublibrary, which renders it's output to the "Picture in
  11. Picture" of a Picasso IV or CV/3D Graphics Board. So if you want
  12. to use this sublibrary, you have to own one of those two GFX
  13. Boards. If not, just use the normal sublibraries in rtgmaster_user.lha.
  14. There might be a future version which also supports the Permedia 2
  15. GFX Boards. But first i have to know if these Boards support PIP or
  16. not... if you have data about this, please contact me.
  17.  
  18. This version of rtgPIP.library requires that you have Picasso 96 as
  19. Workbench Emulation. If a CV/PPC version of this sublibrary will
  20. appear, it will also support CGX, if not: Not. But anybody wanting
  21. to do a version for CGX himselves: Feel free to contact me for info.
  22.  
  23. ONLY PROGRAMS WHICH DO NOT USE DOUBLEBUFFERING ARE SUPPORTED.
  24. DOUBLEBUFFERED RTGMASTER PROGRAMS WILL MAYBE CRASH IF USED
  25. WITH RTGPIP.LIBRARY !!!
  26.  
  27. What are the advantages of PIP ("Picture in Picture") ?
  28.  
  29. A big disadvantage of games running in a Workbench Window are the
  30. quite time-consuming Color-Remapping-Calculations, which make them
  31. run much slower than when they run on a Screen. Also Direct Video
  32. RAM Access is not possible on WB Window Mode. PIP fixes this (it
  33. has it's own palette and supports Direct Video RAM Access inside
  34. a Workbench Window...). Also it introduces 15-24 Bit Access for
  35. Workbench Windows for rtgmaster the first time. It even makes it
  36. possible to run games on Workbench Window which do not support
  37. this (Genetic Species, for example...). Also the colors are much
  38. more accurate on a 8 Bit Workbench Screen, and it is possible with
  39. it to get rid of Color-Conversions for 15-24 Bit (the hardware can
  40. do this).
  41.  
  42. Sure, it is not much, but it is nice.
  43.  
  44. Some speed data:
  45.  
  46. flame in a screen: 65 fps
  47. flame in a conventional window: 24 fps
  48. flame on a PIP on a 16 Bit 800x600 Workbench: 50 fps
  49.  
  50. WarpHeretic: runs the same speed like on a window !!!
  51.  
  52. There are some ENV-Variables for this sublibrary:
  53.  
  54. RTGPIP:
  55.  
  56. Forces the display instead on a WB Window to a Pubscreen with the
  57. specified name. Did not work when i tried it, so better don't try
  58. around with this... but maybe i just tried the wrong screen ?
  59.  
  60. PIPFormat:
  61.  
  62. Force the PIP to use a specific format. You have to know what you
  63. are doing to not make the program crash or behave strange. Forcing a
  64. 16 Bit-only program to 24 Bit output is normally NO good idea :)
  65.  
  66. Values:
  67.  
  68. #define ARGB32 1L
  69. #define RGB24  2L
  70. #define RGB16  4L
  71. #define RGB15  8L
  72. #define ABGR32 16L
  73. #define BGR24  32L
  74. #define RGBA32 256L
  75. #define LUT8   512L
  76. #define RGB15PC  2048L
  77. #define BGR15PC  4096L
  78. #define RGB16PC  8192L
  79. #define BGR16PC  16384L
  80. #define BGRA32   32768L
  81. #define YUV422   65536
  82. #define YUV411   131072
  83.  
  84. As default the format of the choosen screenmode is used. If a "force"
  85. does not work with your GFX Board, rtgPIP.library does a fallback to
  86. the default mode.
  87.  
  88. Programmers who only want to support ONE specific mode can override
  89. the mode by specifying
  90.  
  91. rtg_ForceMode
  92.  
  93. which is defined as
  94.  
  95. rtg_ForceMode = rtg_ChangeColors+1
  96.  
  97. With this you for example can force a MPEG Decoder to force the program
  98. to YUV422 *always*. Note that CopyRtgBlit currently cannot decode YUV,
  99. provide your own functions as MPEG-Decoder-Programmer. Might change in
  100. the future...
  101.  
  102. PIPNOCLEAR:
  103.  
  104. Most apps (for example WarpSNES) look best with a black background. Some
  105. though (for example the flame demo) do not look good with that. To disable
  106. the black background set this env-variable.
  107.  
  108. IMPORTANT NOTE:
  109.  
  110. Programs that use *Double Buffering* (like NAPALM) are currently NOT
  111. supported by the rtgPIP.library. They will hopefully be supported in
  112. the future. I would really like to play NAPALM in a Workbench Window :)
  113.  
  114.  
  115. ============================= Archive contents =============================
  116.  
  117. Original  Packed Ratio    Date     Time    Name
  118. -------- ------- ----- --------- --------  -------------
  119.    29236   12423 57.5% 02-Mar-99 22:37:04  rtgPIP.library
  120.     3957    1957 50.5% 02-Mar-99 22:40:50  rtgPIP.readme
  121. -------- ------- ----- --------- --------
  122.    33193   14380 56.6% 05-Mar-99 01:28:38   2 files
  123.